With so many regex functions out there in every programming language we should be little bit more detailed in our documentation what the function does, i.e.

• That it searches the whole string
• That it supports group matching
• That it stops after the first match?
• How to use it in our configuration with some examples

Also, the function should just be named regex_match. Or do you have any objections?

Tests should be added as well.

And please check whether this solves https://community.icinga.com/t/regex-and-functions/2565

1. Done.
2. Done.
3. Done.
4. Done.
5. Yes, I have. The name I've chosen clearly indicates what exactly the function does.
6. Done.
7. Yes, it does.

I still opt for regex_match. PHP's preg_match, Python's re.match, C++'s regex_match, ... do the same thing, right?

Fine.

@cla-bot check